GUI settings: Menus

Changing menu entries

The list contains the menu definition for the browser window menus.

Select the entry you want to modify from the listview. Use the Add button to add a new blank entry after the currently selected one. Use the Del button to remove the selected entry.

Type

Select the type of this entry.

Menu	A menu entry, appearing in the menu bar.
Item	A menu item.
Sub	A menu sub-item. or another Sub definition.
----	A separator item.

Make sure the menu is correctly built. That is, items and separators can only appear within a menu (that is, not at the top of the list), and sub-items can only immediately follow items or other sub-items. If the menu structure is incorrect, the INVALID indicator is lit.

An incorrectly built menu results in no menu at all. Should this happen, and you are locked out because the menu to start the GUI settings is gone, just open a shell window and type

   AWeb3:AWebCfg GUI

to open the settings window again.

Title

Type the title as you like it to appear in the menu.

Shortcut

Type a one-character shortcut for the menu, or leave this field blank for no shortcut.

Command

In this field, you can type the Arexx command that should be executed when you select the menu item.

In the command string, you can use the following parameter specifiers:

%u URL currently displayed in the browser window.
%n screen name that AWeb is running on.
%i ID of frame that has focus.
%t title of the document, as shown in the window title bar.
%c configuration name.

%u	URL currently displayed in the browser window.
%n	screen name that AWeb is running on.
%i	ID of frame that has focus.
%t	title of the document, as shown in the window title bar.
%c	configuration name.

In addition to ARexx commands, there are a few special strings you can enter. Some strings will result in a checkmark, others are merely a shortcut for functionality not available in a single ARexx command. All special strings start with the @ character:

@AREXX When the item is selected, open a file requester and let the user pick an ARexx macro to run.
@BGIMAGES Display a checkmark along this item reflecting if backgrounds are on or off.
@BGSOUND Display a checkmark along this item reflecting if background sound is on or off.
@BREAKJS Break javascript programs. This menu item is handled in a special way to work even when a program is running. The normal JSBREAK command would not be handled until a running program has ended by itself.
@DEBUGJS Display a checkmark along this item reflecting if JavaScript debugging is on or off.
@DRAGGING Display a checkmark along this item reflecting if dragging is on or off.
@LOADIMGALL
@LOADIMGMAPS
@LOADIMGOFF Display a checkmark along this item that is mutual exclusive across these items. The checkmark reflects the current image loading status (all images, maps only, or off).
@NOPROXY Display a checkmark along this item reflecting the noproxy status.
@OTHERHOT When the item is selected, open a file requester and let the user pick a hotlist to display.

@AREXX	When the item is selected, open a file requester and let the user pick an ARexx macro to run.
@BGIMAGES	Display a checkmark along this item reflecting if backgrounds are on or off.
@BGSOUND	Display a checkmark along this item reflecting if background sound is on or off.
@BREAKJS	Break javascript programs. This menu item is handled in a special way to work even when a program is running. The normal `JSBREAK` command would not be handled until a running program has ended by itself.
@DEBUGJS	Display a checkmark along this item reflecting if JavaScript debugging is on or off.
@DRAGGING	Display a checkmark along this item reflecting if dragging is on or off.
@LOADIMGALL @LOADIMGMAPS @LOADIMGOFF	Display a checkmark along this item that is mutual exclusive across these items. The checkmark reflects the current image loading status (all images, maps only, or off).
@NOPROXY	Display a checkmark along this item reflecting the noproxy status.
@OTHERHOT	When the item is selected, open a file requester and let the user pick a hotlist to display.

Rearranging menu entries

You can move an entry in the menu. Select the entry, either with the mouse or with the cursor up and down keys. Now you can move the entry up and down in the list with either the arrow up and arrow down buttons, or with the Ctrl + cursor up/down keys.

Options

Settings requesters

Buttons